home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / comm / comm2 / upldbnsp.lha / UploadBonusPro.dok < prev    next >
Text File  |  1996-12-06  |  51KB  |  1,209 lines
  1.   _   _      _              _   ___                    ___
  2.  | | | |_ __| |___  __ _ __| | | _ ) ___ _ _ _  _ ___ | _ \_ _ ___   (C)1996
  3.  | |_| | '_ \ / _ \/ _` / _` | | _ \/ _ \ ' \ || (_-< |  _/ '_/ _ \
  4.   \___/| .__/_\___/\__,_\__,_| |___/\___/_||_\_,_/__/ |_| |_| \___/ F.HARTUNG
  5.  ======|_|=========================================================
  6.  
  7. Inhalt der Anleitung in Deutsch:        Contents of documentation in english:
  8.  
  9.    1. Einleitung                         1. Introduction
  10.    2. Voraussetzungen                    2. Requirements
  11.    3. Faehigkeiten                       3. Features
  12.    4. Arbeitsweise                       4. Method of working
  13.    5. Dateierklaerung                    5. Fileintroduction
  14.  
  15.       SERVER:                               SERVER:
  16.    6. Installierung des Serverprg        6. Install of the serverprg
  17.    7. Konfiguration des Serverprg        7. Configs of the serverprg
  18.  
  19.       CLiENT:                               CLiENT:
  20.    8. Installierung des Clientprg        8. Install of the clientprg
  21.    9. Konfiguration des Clientprg        9. Configs of the clientprg
  22.  
  23.   10. Deinstallation                    10. Deinstallation
  24.   11. Versionsgeschichte                11. History & Changes
  25.   12. Haftungswiderspruch               12. Responsibility
  26.   13. Urheberrechte                     13. Copyrights
  27.   14. Danksagungen & Gruesse            14. Thanks & greetings
  28.   15. Fehlermeldungen                   15. Updates & bugreports
  29.   16. Benutzungsbedingungen             16. Restrictions of use
  30.  
  31.  
  32.                                /X\ /X\ /X\
  33.                                \X/ \X/ \X/
  34.  
  35.  
  36. 1. Einleitung (Introduction):
  37. -----------------------------
  38.  
  39. UploadBonusPro ist das Gutschriften-Tool fuer Mailboxprogramm Prometheus.
  40. UploadBonusPro is the credittool of the bbs-prg prometheus.
  41.  
  42. UploadBonusPro vergibt Downloadfreiraum-Gutschriften anhand des Download-
  43. Protokolls an die Uploader (Absender) von Files.
  44.  
  45. UploadBonusPro ist eine Weiterentwicklung der Idee, die hinter den bereits
  46. bekannten Gutschriftentools XLSpicePro von Andreas Horn und FREE4DOWN
  47. von Maik Schreiber steckt.
  48.  
  49. Obwohl ich mich bei Andreas Horn fuer XLSpicePro registrieren liess, gab es
  50. trotz sofort folgenden bugreports keine Reaktion mehr von ihm.  XLSpicePro
  51. schien mir faehig zu sein, jedoch hat es Fehler, die ich langfristig nicht
  52. fuer meine User in kauf nehmen wollte.
  53.  
  54. Free4Down von Maik Schreiber war mir einfach zu einfach. :)
  55.  
  56. Ich wollte meinen Usern ganz einfach mehr bieten und natuerlich auch eine
  57. einwandfreie Funktion sowie Kontrolle ueber alle Vorgaenge.
  58. Leider liess sich das mit meinen einfachen Moeglichkeiten und der unaus-
  59. reichenden Ahnung erst zu diesem Zeitpunkt realisieren.   Da die User
  60. meiner Box sehr aktiv und ebenfalls sehr unzufrieden mit der einzig
  61. verfuegbaren XLSpicePro-Version sind, hat deren Klagen ueber diesen
  62. Zustand meiner Motivation den Extrakick gegeben.
  63.  
  64. UploadBonusPro ist sozusagen aus einer Not heraus entstanden, wobei mir
  65. die Programmierung ohne eine dominierende Logik nicht moeglich gewesen
  66. waere, da ich mich eigentlich NICHT Programmierer nenne und keine all-
  67. taegliche Routine(n) besitze.
  68.  
  69. Bei der Programmierung von UploadBonusPro bin ich sehr kompromisslos
  70. gewesen; ich wollte ein stabiles, einwandfreies sowie fehlerfreies
  71. Gutschriftenprogramm - ich bin sicher, dass ich dies bislang einhalten
  72. konnte.
  73.  
  74.  
  75.                                /X\ /X\ /X\
  76.                                \X/ \X/ \X/
  77.  
  78.  
  79. 2. Voraussetzungen (Requirements):
  80. ----------------------------------
  81.  
  82.  -Amiga-Kompatiblen Multitask-Rechner sowie Betriebssystem AmigaOS ab 2.0
  83.  -Arexx-Installation (Rexxmast 36.5)
  84.  -Prometheus-Installation       (1.992)
  85.  -prometheus.library    (2.2)
  86.  -pmbsonline.library    (4.0)
  87.  -UploadBonusPro-Installation (siehe auch Dateierklaerung) ;)
  88.  -rexxsupport.library   (34.9)
  89.  -ptTools.library       (37.0b)
  90.  
  91.  
  92.                                /X\ /X\ /X\
  93.                                \X/ \X/ \X/
  94.  
  95.  
  96. 3. Faehigkeiten (Features):
  97. ---------------------------
  98.  
  99. Hier einige features in Stichworten:
  100.  
  101.  -Das UploadBonusPro-Paket beinhaltet ein UNinstall.bat zum einfachen
  102.   deinstallieren des UploadBonusPro bei Nichtgefallen. :)
  103.  -Fuer UploadBonusPro gibt es eine ausfuehrliche Anleitung.
  104.  -UploadBonusPro wird weiterentwickelt.
  105.  -UploadBonusPro wird nach bugreports debuggt(korrigiert).
  106.  -UploadBonusPro veraendert Daten nur ueber Prometheus, d.h. es
  107.   veraendert NICHT gewaltsam den Inhalt von Userdateien ueber Doszugriff.
  108.  -UploadBonusPro benutzt ordnungsgemaess die Prometheus-Ramstruktur sowie
  109.   den Prometheus-Server zum Ermitteln der benoetigten Daten.
  110.  -UploadBonusPro ist voll multiportkompatibel.
  111.  -UploadBonusPro arbeitet systemkonform und verursacht keine Abstuerze.
  112.  -UploadBonusPro vermeidet moegliches Fehlverhalten durch Beruecksichtigung
  113.   und evtl. Ermittlung beteiligter Faktoren.
  114.  -UploadBonusPro verarbeitet jede Zeile des Downloadprotokolls nur ein
  115.   einziges Mal, UploadBonusPro merkt sich Zeitpunkt sowie Zeilennummer.
  116.  -UploadBonusPro hat einen eigenen Dupecheck nach MSGID.
  117.  -UploadBonusPro hat sekundaer auch einen Dupecheck mit Filenamen fuer
  118.   Files ohne MSGID.
  119.  -UploadBonusPro arbeitet mit Tempdateien und blockiert dadurch weder die
  120.   Downloadprotokolldatei noch sonstige.
  121.  -UploadBonusPro prueft unter anderem Gruppen, wodurch man gezielt und
  122.   komfortabel die Userschafteinstellung ueber den Gruppeneditor von
  123.   Prometheus vornehmen kann.
  124.  -UploadBonusPro laesst das Downloadprotokoll UNVERAENDERT.
  125.  -UploadBonusPro loescht das Downloadprotokoll NICHT.
  126.  -UploadBonusPro liest den aktuellen Brettpfad aus der Ramstruktur aus.
  127.  -UploadBonusPro ueberspringt doppelte Downloads.
  128.  -UploadBonusPro ueberspringt Downloads eigener Uploads.
  129.  -UploadBonusPro macht eine Gutschrift nur einmal, auch bei mehrfachem
  130.   Download durch denselben User.
  131.  -UploadBonusPro wird NICHT durcheinandergebracht, wenn die Download-
  132.   protokolldatei durch DRITTE veraendert oder geloescht wird.
  133.  -UploadBonusPro frist kein Brot, ist jedoch trocken und stubenrein.
  134.  -UploadBonusPro legt alle Dateien im normal lesbaren Amiga-ASCII-Format an.
  135.  -UploadBonusPro ermoeglicht dem SysOp, JEDEM User einen ANDEREN Prozent-
  136.   wert fuer seine Bonusgutschriften ueber die Vergabe von FREI
  137.   definierbaren Prometheus-Gruppen zuzuordnen.
  138.  -UploadBonusPro kann Bonusgutschriften LIMITIEREN, z.B. nur 10 Gutschriften,
  139.   danach gibt es auch bei weiteren Downloads keine Bonusgutschriften mehr.
  140.  -UploadBonusPro berechnet prozentuale Bonusgutschriften NACHKOMMAGENAU und
  141.   rundet auf falls noetig.
  142.  -UploadBonusPro erstellt auf Wunsch eine Brettverwalter-Informationsmail
  143.   fuer jede Bonusgutschrift durch Downloads aus seinem Brett.
  144.  -UploadBonusPro fuehrt eine Bonus-Backupdatei, wodurch Bonusgutschriften,
  145.   welche durch Reset/Absturz vor dem Speichern der Userdaten nicht in die
  146.   Userdaten uebernommen werden, VOLLAUTOMATISCH und natuerlich nachtraeglich
  147.   gutgeschrieben werden koennen.
  148.  -UploadBonusPro ist einfach lueckenlos in Logik und Durchfuehrung.
  149.  
  150.  
  151.                                /X\ /X\ /X\
  152.                                \X/ \X/ \X/
  153.  
  154.  
  155. 4. Arbeitsweise (Method of working):
  156. ------------------------------------
  157.  
  158. UploadBonusPro besteht aus eigenstaendigem Serverprg und Clientprg.
  159.  
  160. Das Serverprg ist das Herzstueck von UploadBonusPro; es liest das Download-
  161. Protokoll (prometheus:protokolle/download.prt) und entscheidet anhand von
  162. diversen Checks , beeinflusst durch DEINE vorgegebene Einstellung(Konfig),
  163. ueber die Vergabe von Gutschriften.  Das Serverprg stellt die Gutschriften
  164. fest , verbucht sie jedoch nicht; es speichert die Bonuswerte, addiert sie
  165. falls bereits eine Gutschriftendatei vorhanden ist.
  166.  
  167. Das Clientprg benoetigt die durch das Serverprg angelegten Gutschriften-
  168. daten, um einen Sinn zu ergeben; ohne den regelmaessigen (taeglich!) Lauf
  169. des Serverprgs ist die Benutzung des Clientprgs sinnlos.  Das Clientprg
  170. verbucht die vom Serverprg festgestellten Gutschriften auf das Download-
  171. freiraumkonto des Users,der die Datei(File) upgeloadet hat,fuer die es
  172. eine Gutschrift gab.
  173.  
  174. Server- sowie Clientprg legen jeweils ein aussagekraeftiges Protokoll
  175. an (siehe Punkt 5. Dateierklaerungen).
  176.  
  177. Eigentlich eine ganz einfache Sache oder ?  :-)
  178.  
  179.  
  180.                                /X\ /X\ /X\
  181.                                \X/ \X/ \X/
  182.  
  183.  
  184. 5. Dateierklaerung (Fileintroduction):
  185. --------------------------------------
  186.  
  187. Der Dateiname des UploadBonusPro-Serverprg ist:
  188.  UBPserver
  189.  
  190. Der Dateiname des UploadBonusPro-Clientprg ist:
  191.  UBPclient
  192.  
  193. Es werden folgende standartisierte AmigaDOS-Befehle benoetigt:
  194.  c:delete  ... wird zum Loeschen benoetigt
  195.  c:echo    ... Anlegen der Infomail sowie Protokollzeilen
  196.                (interner AmigaDOS-Befehl, hier wird zusaetzlich
  197.                 die Ausfuehrung getestet.)
  198.  c:protect ... schuetzt und entschuetzt Sicherheitsdatei
  199.  c:type    ... zum Kopieren und Anfuegen
  200.  c:execute ... Ausfuehren von batchdateien
  201.  
  202. Weiterhin werden folgende Libraries benoetigt:
  203.  libs:rexxsupport.library ... fuer einige rexxfunktionen
  204.  libs:ptTools.library     ... einige Prometheusansteuerungsroutinen
  205.  
  206. Alle Dateien, die vom UploadBonusPro-Serverprg angelegt werden, sind
  207. im normal lesbarem Amiga-ASCII-Format.
  208.  
  209. Der Dateiname der Configdatei fuer das UploadBonusPro-Serverprg ist:
  210.  prometheus:daten/UploadBonusPro_gh.CFG      ... Beispiel im Lieferumfang
  211.  
  212. Folgende Dateien werden vom UploadBonusPro-Server angelegt:
  213.  ram:UBPgh                                   ... Sicherheitsdatei
  214.  ram:UBPgh_echotest                          ... Testdatei fuer c:echo
  215.  prometheus:daten/UploadBonusPro_gh.dat      ... gemerkter Zeitpunkt
  216.  prometheus:daten/UploadBonusPro_gh2.dat     ... gemerkte Zeilennummer
  217.  prometheus:protokolle/UploadBonusPro_gh.prt ... Gutschriftprotokoll Kurzform
  218.  prometheus:protokolle/download.prt_temp     ... Tempdatei fuer Verarbeitung
  219.  prometheus:protokolle/download.prt_2nd      ... gemerkte Protokollzeilen
  220.  prometheus:texte/UploadBonusPro_gh.txt      ... Userhilfstext fuer Clientprg
  221.  prometheus:user/<USER>/°UBPproto_gh.prt     ... userglobales Protokoll
  222.  prometheus:user/<USER>/°UBPproto_gh.prt_bak ... Backup der vorherigen Datei
  223.  prometheus:user/<USER>/°UBPbyte_gh.dat      ... Gutschriftvolumen in Byte
  224.  prometheus:user/<USER>/°UBPdupeFILE_gh.dat  ... Dupeprotokoll mit Filenamen
  225.  prometheus:user/<USER>/°UBPdupeMSGID_gh.dat ... Dupeprotokoll mit MSGIDs
  226.  
  227. Textdateien, die das UploadBonusPro-Serverprg auf Wunsch in die infomail
  228. kopiert (max.10 Zeilen) :
  229.  prometheus:texte/UBPinfomail-KOPF_gh.txt    ... Kopftextdatei fuer infomail
  230.  prometheus:texte/UBPinfomail-FUSS_gh.txt    ... Fusstextdatei fuer infomail
  231.  (kann ueber Konfigurationsdatei veraendert werden!)
  232.  
  233. Textdatei, die das UploadBonusPro-Serverprg fuer das infomail-Batch
  234. anlegt und nach dem Aufruf desselben wieder loescht:
  235.  ram:UploadBonusPro-infomail
  236.  (kann ueber Konfigurationsdatei veraendert werden!)
  237.  
  238. Textdatei, die das UploadBonusPro-Serverprg fuer das BVinfomail-Batch
  239. anlegt und nach dem Aufruf desselben wieder loescht:
  240.  ram:UBP-BVinformation
  241.  (kann ueber Konfigurationsdatei veraendert werden!)
  242.  
  243. Batchdatei, ueber die das UploadBonusPro-Serverprg infomail verschickt:
  244.  prometheus:batches/UBPinfomail_gh.bat
  245.  (kann ueber Konfigurationsdatei veraendert werden!)
  246.  
  247. Batchdatei, ueber die das UploadBonusPro-Serverprg BVinfomail verschickt:
  248.  prometheus:batches/UBPbvinfomail_gh.bat
  249.  (kann ueber Konfigurationsdatei veraendert werden!)
  250.  
  251. Batchdatei, ueber die das UploadBonusPro-Serverprg SysOpmail verschickt:
  252.  prometheus:batches/UBPsysopmail_gh.bat
  253.  
  254. Folgende vom UploadBonusPro-Server angelegten Dateien werden vom
  255. UploadBonusPro-Client weiterverarbeitet (lesen, download, loeschen):
  256.  prometheus:user/<USER>/°UBPproto_gh.prt     ... userglobales Protokoll
  257.  prometheus:user/<USER>/°UBPbyte_gh.dat      ... Gutschriftvolumen in Byte
  258.  
  259. Folgende mitgelieferte Datei wird vom UploadBonusPro-Client angezeigt:
  260.  prometheus:texte/UploadBonusPro_gh.txt      ... Userhilfstext fuer Clientprg
  261.  
  262. Das UploadBonusPro-Clientprg fuehrt unter folgendem Dateinamen ein box-
  263. globales Protokoll fuer das Verbuchen von Gutschriften und das Verbuchen
  264. von Bonus-Backup-Gutschriften:
  265.  prometheus:protokolle/UBPclient-Freiraum_gh.prt   ...Protokoll fuer SysOp
  266.  
  267. Folgende Datei, welche vom UBP-Clientprg angelegt und geloescht wird, sorgt
  268. dafuer,dass sich bei einem Reset/Absturz kein User mehr darueber beschweren
  269. kann, dass seine UploadBonusPro-Gutschrift durch den dummen Boxhaenger nicht
  270. in die Userdaten gespeichert wurde:
  271.  prometheus:user/<USER>/°UBPbyte_gh.bak      ... geniale Bonus-Backupdatei
  272.  
  273. Der UploadBonusPro-Client erstellt bzw. erweitert wunschgemaess die Datei
  274. fuer Nachricht an Port (OLM) unter:
  275.  ram:<port>.msg         ... siehe Clientprg-Aufrufparameter 23000
  276.  
  277. Batchdatei zum Deinstallieren der UploadBonusPro-Dateien:
  278.  UNinstall.bat  ... mehr dazu siehe Punkt Deinstallation
  279.  
  280. Die Anleitung von UploadBonusPro hat den Dateinamen:
  281.  UploadBonusPro.dok  :)
  282.  
  283.  
  284.                                /X\ /X\ /X\
  285.                                \X/ \X/ \X/
  286.  
  287.  
  288.   ___
  289.  / __| ___ _ ___ _____ _ _
  290.  \__ \/ -_) '_\ V / -_) '_|
  291.  |___/\___|_|  \_/\___|_|
  292.  --------------------------
  293.  
  294. 6. Installierung des Serverprg (Install of the serverprg):
  295. ----------------------------------------------------------
  296.  
  297. Der Dateiname des UploadBonusPro-Serverprg ist:
  298.  UBPserver
  299.  
  300. Das UploadBonusPro-Serverprg in ein beliebiges Verzeichnis kopieren,
  301. am besten in c: oder prometheus: oder auch prometheus:extern/
  302.  
  303. Damit das Serverprg regelmaessig laeuft, am besten fest in den Zeitplan
  304. von Prometheus eintragen; der Aufruf ist einfach, Befehl RUN gefolgt
  305. von dem Programmnamen ohne weitere Parameter. Da alle Arbeitsvorgaenge
  306. von dem Serverprg an die Standartausgabe ausgegeben werden, kannst Du
  307. diese entweder mittels Zusatz von >NIL: ins "Nichts" umleiten, um Speed
  308. zu gewinnen, oder Du leitest die Ausgaben ueber
  309. >>prometheus:protokolle/denkdirwasfeinesaus in eine Datei um , welche
  310. Du Dir jederzeit ueber den Prometheus-Server anzeigen lassen kannst.
  311.  
  312. Du kannst das Serverprg auch direkt im CLi/Shell von Hand aufrufen;die
  313. Arbeitsvorgaenge werden dann direkt dort ausgegeben , sofern sie nicht
  314. mit einem Zusatz wie >NIL: o.ae. umgeleitet werden.
  315.  
  316. Das Serverprg kann an bestimmten Stellen mittels CTRL+D geregelt abge-
  317. brochen werden; dies fuehrt zwar nicht zu Fehlern, sollte jedoch nicht
  318. die Regel sein.
  319.  
  320.  
  321.                                /X\ /X\ /X\
  322.                                \X/ \X/ \X/
  323.  
  324.  
  325. 7. Konfiguration des Serverprgs (Configs of the serverprg):
  326. ----------------------------------------------------------
  327.  
  328.  KONFIGURATIONSDATEI:
  329.  --------------------
  330. Die Konfigurationsdatei heisst prometheus:daten/UploadBonusPro_gh.CFG
  331. Eine Beispieldatei mit Standarteinstellung ist im Lieferumfang/Archiv
  332. enthalten.
  333.  
  334. Die Konfigurationsdatei wird vom UploadBonusPro-Serverprg beim Start
  335. ausgewertet.  Der Aufrufparameter "NOCFGFILE" verhindert das Auswerten
  336. der Konfigurationsdatei beim Start (=Standartwerte aktiv!).
  337. Es wird jeweils nur das erste Wort einer Zeile ausgewertet, sodass eine
  338. Beschreibung, Notiz oder Bemerkung dahinter, getrennt durch mind. einem
  339. Leerzeichen, moeglich ist.
  340.  
  341.  
  342. Bisher sind folgende Konfigurationszeilen moeglich:
  343.  
  344.  Zeile: | Standart:    Erklaerung:
  345.  -------+-------------------------------------------------------------
  346.         |
  347.   1     | 60           Wartelimit in Sekunden: minimal 0 , maximal 600
  348.         |              Sekunden.  Stellt das UploadBonusPro-Serverprg
  349.         |              vor der unmittelbaren Gutschrift fest, dass der
  350.         |              User, der die Gutschrift erhalten soll, online
  351.         |              ist, wird die Wartelimitzeit abgewartet.
  352.         |              Nach Ablauf dieser Zeit wird der Gutschrift-
  353.         |              vorgang gemerkt, um diesen spaeter vorzunehmen.
  354.         |
  355.   2     |  1           infomail-batchaufruf ein(1) oder aus(0)
  356.         |              ausgeschaltet wird das infomail-batch nicht mehr
  357.         |              aufgerufen, unabhaengig davon, ob es vorhanden ist.
  358.         |
  359.   3     |  100         prozentuale(1-100) Bonusgutschrift von Dateigroesse
  360.         |
  361.   4     |  0           Prozentinformation an User ein(1) oder aus(0)
  362.         |              ausgeschaltet wird in infomailtext sowie userglobales
  363.         |              protokoll keine Prozentangabe mehr gemacht.
  364.         |
  365.   5     |  1           Bonusbyteinformation an User ein(1) oder aus(0)
  366.         |              ausgeschaltet wird in infomailtext sowie userglobales
  367.         |              protokoll keine Bonusbyteangabe mehr gemacht.
  368.         |
  369.   6     |  1           Fileinformation an User ein(1) oder aus(0)
  370.         |              ausgeschaltet wird in infomailtext sowie userglobales
  371.         |              protokoll keine Fileangabe mehr gemacht.
  372.         |
  373.   7     |  1           Brettinformation an User ein(1) oder aus(0)
  374.         |              ausgeschaltet wird in infomailtext sowie userglobales
  375.         |              protokoll keine Brettangabe mehr gemacht.
  376.         |
  377.   8     |  1           userglobales Protokoll ein(1) oder aus(0)
  378.         |              ausgeschaltet wird fuer ALLE User kein userglobales
  379.         |              protokoll mehr angelegt, unabhaengig von Verteilung
  380.         |              der Gruppe UBP-NOPROTO.
  381.         |
  382.   9     |  1           Brettverwaltercheck ein(1) oder aus(0)
  383.         |              ausgeschaltet wird der Brettverwaltername nicht mehr
  384.         |              ausgelesen, was fuer nachfolgende Konfigurationszeilen
  385.         |              ausschlaggebend ist.
  386.         |
  387.  10     |  0           BVinfomail-batchaufruf ein(1) oder aus(0).
  388.         |              ausgeschaltet wird das BVinfomail-batch nicht mehr
  389.         |              aufgerufen, unabhaengig davon, ob es vorhanden ist.
  390.         |
  391.  11     |  1           Userbonus bei BVdownload ein(1) oder aus(0).
  392.         |              eingeschaltet bekommt ein User die Bonusgutschrift,
  393.         |              auch wenn der Brettverwalter sein Upload downgeloadet
  394.         |              hat.
  395.         |
  396.  12     |  1           BVbonus bei Userdownload ein(1) oder aus(0).
  397.         |              eingeschaltet bekommt auch ein Brettverwalter fuer
  398.         |              den Upload im eigenen Brett, welcher von einem User
  399.         |              downgeloadet wurde, eine Bonusgutschrift.
  400.         |
  401.  13     |  ram:UploadBonusPro-infomail    ...Datei, in der der infomailtext
  402.         |              an user erstellt wird und an das infomail-batch
  403.         |              uebergeben wird.
  404.         |
  405.  14     |  ram:UBP-BVinformation    ...Datei, in der der BVinfomailtext an
  406.         |              BV erstellt wird und an das bvinfomail-batch ueber-
  407.         |              geben wird.
  408.         |
  409.  15     |  prometheus:batches/UBPinfomail_gh.bat    ...Batchdatei, welche
  410.         |  zum Verschicken der infomail an User aufgerufen wird.
  411.         |
  412.  16     |  prometheus:batches/UBPbvinfomail_gh.bat  ...Batchdatei, welche
  413.         |  zum Verschicken der BVinformation an Brettverwalter aufgerufen
  414.         |  wird.
  415.         |
  416.  17     |  1           Gruppencheck generell aus(0) oder ein(1)
  417.         |              Hauptschalter fuer alle Gruppenchecks, welche
  418.         |              nachfolgend noch einzeln aus(0)- oder eingestellt(1)
  419.         |              werden koennen.
  420.         |
  421.  18     |  1           Gruppencheck Gruppe UBP-KASCHIER aus(0) oder ein(1)
  422.         |
  423.  19     |  1           Gruppencheck Gruppe UBP-NOBONUS aus(0) oder ein(1)
  424.         |
  425.  20     |  1           Gruppencheck Gruppe UBP-NOPROTO aus(0) oder ein(1)
  426.         |
  427.  21     |  0           Gruppencheck Gruppe UBP-NOINFO aus(0) oder ein(1)
  428.         |
  429.  22     |  0           Gruppencheck Gruppe UBP-NOBVINFO aus(0) oder ein(1)
  430.         |
  431.  23     |  0           Gruppencheck der UBP-BONUSxxx -Gruppen aus(0) oder
  432.         |              ein(1)  (Achtung: Gruppenname z.B. UBP-BONUS13)
  433.         |
  434.  24     |  0           Gruppencheck der UBP-LIMITxxxxx -Gruppen aus(0) oder
  435.         |              ein(1)  (Achtung: Gruppenname z.B. UBP-LIMIT1000)
  436.         |
  437.  25     |  0           Gruppencheck Gruppe UBP-NOLIMIT aus(0) oder ein(1)
  438.         |
  439.  26     |  0           Filezugrifflimit aus(0) oder mit einem Limit von
  440.         |              1-99999 Zugriffen(=Downloads) begrenzen.
  441.         |
  442.  27     |  0           Bonusgutschrift fuer FREE-DL-Bretter aus(0) oder
  443.         |              ein(1).  Ausgeschaltet bekommen Uploader keine
  444.         |              Gutschriften fuer Downloads aus einem Brett,
  445.         |              welches Brettratio 0 (=FREE-DL) hat.
  446.         |
  447.  28     |  0           Bonusgutschrift fuer FREE-DL-Bretter mit speziellem
  448.         |              Prozentwert aus(0) oder einschalten; durch eine
  449.         |              Prozentzahl von 1 bis 100.  Bei aus(0) wird der
  450.         |              normal gueltige Prozentwert genommen.
  451.         |
  452.  29     |  1           Dupecheck generell aus(0) oder ein(1)
  453.         |              sozusagen der Hauptschalter fuer den Dupecheck.
  454.         |
  455.  30     |  0           BonusGruppen-Richtung auf kleinsten(0) oder
  456.         |              groessten(1) Wert.  Ist ein User in mehreren
  457.         |              UBP-BONUSxxx -Gruppen,wie z.B. UBP-BONUS010 (=10%)
  458.         |              und in der Gruppe UBP-BONUS99 (=99%) wird bei
  459.         |              aus(0) der kleinste Wert, also 10% und bei ein(1)
  460.         |              der groesste, also 99% fuer die Berechnung der
  461.         |              Bonusgutschrift uebernommen.
  462.         |
  463.  31     |  0           LimitGruppen-Richtung auf kleinsten(0) oder
  464.         |              groessten(1) Wert.  Ist ein User in mehreren
  465.         |              UBP-LIMITxxx -Gruppen,wie z.B. UBP-LIMIT100 (=100)
  466.         |              und in der Gruppe UBP-LIMIT1000 (=1000) wird bei
  467.         |              aus(0) der kleinste Wert, also 100 und bei ein(1)
  468.         |              der groesste, also 1000 fuer die weitere Verarbeitung
  469.         |              des Filezugrifflimit fuer Bonusgutschrift uebernommen.
  470.         |
  471.  32     |  prometheus:texte/UBPinfomail-KOPF_gh.txt   ...Kopftextdatei
  472.         |              fuer Erstellung von infomail.  Max. 10 Zeilen dieser
  473.         |              Textdatei werden an den Kopf der infomail hinzugefuegt.
  474.         |              (Einschalten ueber Zeile 34 nicht vergessen!)
  475.         |
  476.  33     |  prometheus:texte/UBPinfomail-FUSS_gh.txt   ...Fusstextdatei
  477.         |              fuer Erstellung von infomail.  Max. 10 Zeilen dieser
  478.         |              Textdatei werden an den Kopf der infomail hinzugefuegt.
  479.         |              (Einschalten ueber Zeile 35 nicht vergessen!)
  480.         |
  481.  34     |  0           Kopfzeilendatei (Zeile 32) hinzufuegen in infomail
  482.         |              aus(0) oder ein(1)
  483.         |              Eingeschaltet und vorausgesetzt die Datei ist
  484.         |              vorhanden , werden max.10 Zeilen an den Kopf der
  485.         |              infomail hinzugefuegt.
  486.         |              Moegliche Verwendung, ein eigener Einleitungstext
  487.         |              oder Boxlogo.
  488.         |
  489.  35     |  0           Fusszeilendatei (Zeile 33) hinzufuegen in infomail
  490.         |              aus(0) oder ein(1)
  491.         |              Eingeschaltet und vorausgesetzt die Datei ist
  492.         |              vorhanden , werden max.10 Zeilen an den Fuss der
  493.         |              infomail hinzugefuegt.
  494.         |              Moegliche Verwendung, ein eigener Abschlusstext
  495.         |              oder Hinweis wie der User die Bonusgutschrift
  496.         |              auf sein Downloadfreiraumkonto gutgeschrieben
  497.         |              bekommt, evtl. Befehlsaufruf des UBP-Clientprg.
  498.         |
  499.  36     |  1           Aufruf vom SysOp-Mail-Batch aus(0) oder ein(1),
  500.         |              wenn es gewuenscht wird und dieses Batch existiert,
  501.         |              dann wird es mit den Parametern Datum, Zeit,
  502.         |              verarbeitete Zeilen, Gutschriftenanzahl sowie
  503.         |              Gesamtgutschriftenbytemenge aufgerufen.  Es laesst
  504.         |              sich so leicht ein Arbeitsprotokoll an beliebige
  505.         |              Empfaenger (SysOp oder Brett) verschicken.
  506.         |              Ein Beispielbatch ist vorhanden.
  507.         |
  508.         |
  509.         |
  510.         |
  511.         |
  512.         |
  513.  
  514. Die unter Spalte "Standart" stehenden Angaben sind jeweils die Standart-
  515. einstellung , welche der UploadBonusPro-Server verwendet, wenn keine
  516. Konfigurationsdatei vorhanden ist, oder die Angabe der jeweiligen Zeile
  517. ausserhalb des moeglichen Bereiches liegt. Sollte das Serverprg beim Laden
  518. der Konfigurationsdatei Fehler finden, so werden diese direkt angezeigt.
  519.  
  520. Die Moeglichkeiten der Konfigurationsdatei werden weiterhin ausgebaut;
  521. neue Einstellungsmoeglichkeiten werden unten angehaengt.
  522.  
  523.  
  524.  GRUPPEN:
  525.  --------
  526. Das Arbeitsverhalten von dem UploadBonusPro-Serverprg kann man mit
  527. Gruppen, welche man im Prometheus-Server im Gruppen-Editor anlegen KANN,
  528. beeinflussen.
  529.  
  530. Generell muss man nicht alle moeglichen Gruppen anlegen,sondern nur die,
  531. deren Vorhandensein fuer die jeweils INDIVIDUELLE Konfiguration LOGISCH
  532. und erforderlich ist.  Es koennen beliebige bzw. ALLE Gruppen weggelassen
  533. werden; die Gruppen sind nur Moeglichkeiten, die man nutzen kann, wenn man
  534. moechte.
  535.  
  536. UBP-KASCHIER - User dieser Gruppe koennen durch ihre Downloads KEINE
  537.                Gutschriften verursachen; sinnvoll waere es vielleicht,
  538.                den SYSOP, Verwalter sowie GAST- und evtl. vorhandene
  539.                SAUGER- oder SUPPORT-User mit dieser Gruppe zu belegen.
  540.  
  541. UBP-NOBONUS  - User, die in dieser Gruppe sind, bekommen keine Gutschrift,
  542.                wenn Ihre Uploads downgeloadet werden.
  543.                Es empfiehlt sich, diese Gruppe allen Gast-Usern sowie
  544.                SAUGER- oder SUPPORT-Usern zu geben.
  545.  
  546. UBP-NOPROTO  - Fuer User dieser Gruppe wird bei einer Bonusgutschrift
  547.                KEIN userglobales Protokoll im Postfach-DIR angelegt.
  548.                Generell jedoch eine ausfuehrliche Kopie, damit der SysOp
  549.                fuer sich ein Protokoll von dem User hat; auf dieses interne
  550.                Protokoll hat der User ueber das Clientprg natuerlich KEINEN
  551.                Zugriff.
  552.  
  553. UBP-NOINFO   - User dieser Gruppe bekommen bei einer Bonusgutschrift
  554.                KEINE UploadBonusPro-infomail in das User-Postfach.
  555.  
  556. UBP-NOBVINFO - Brettverwalter dieser Gruppe bekommen bei Bonusgutschriften
  557.                von Files "Ihrer" Bretter keine BVinformation in Ihr
  558.                User-Postfach.
  559.  
  560. UBP-BONUSxxx - Ueber Gruppen wie z.B. (FREI WAEHLBAR!!!) "UBP-BONUS13"
  561.                bekommen deren teilnehmende User eine Bonusgutschrift
  562.                mit 13%.  Erlaubt sind volle Werte von 1 bis 100, welche
  563.                fuer 1% bis max. 100% stehen.  Ein User kann auch Teilnehmer
  564.                in mehreren "UBP-BONUSxxx"-Gruppen sein; zur Berechnung
  565.                wird der kleinste Wert genommen, es sei denn, in der
  566.                Konfigurationsdatei wurde es entsprechend anders eingestellt.
  567.  
  568. UBP-LIMITxxxxx - Ueber FREI WAEHLBARE Gruppen wie z.B. "UBP-LIMIT1000" wird
  569.                die Limitierung der Bonusgutschriften fuer deren Teilnehmer
  570.                auf 1000 begrenzt.  Ein User kann auch Teilnehmer in mehreren
  571.                "UBP-LIMITxxxxxx"-Gruppen sein; zur weiteren Verarbeitung
  572.                wird der kleinste Wert genommen, es sei denn, in der
  573.                Konfigurationsdatei wurde es anders eingestellt.
  574.  
  575. UBP-NOLIMIT  - Mit dieser Gruppe befreit man die Teilnehmer von der
  576.                Limitierung der Bonusgutschriften.  Ist ein User in dieser
  577.                Gruppe, wird nicht geprueft, ob er in den Gruppen
  578.                "UBP-LIMITxxxxx" eingetragen ist.
  579.  
  580. Hinweis zu den Gruppen: das Pruefen aller Gruppen sowie einzelner Gruppen
  581. kann ueber die Konfigurationsdatei gezielt aus/eingeschaltet werden.
  582.  
  583.  
  584.  iNFOMAIL:
  585.  ---------
  586. Wenn Du moechtest, dass der Uploader fuer jede Gutschrift eine PMail
  587. zugeschickt bekommt, kannst Du unter Verwendung der Batchdatei
  588. prometheus:batches/UBPinfomail_gh.bat ein Mailprogramm wie z.B.
  589. EBLcopy von dem UploadBonusPro-Server aufrufen lassen.
  590.  
  591. Beim Aufruf wird als Parameter Textdatei, Empfaenger und Brettverwalter
  592. uebergeben;  Brettverwalter natuerlich nur, falls das Brett, aus dem
  593. downgeloadet wurde, einen Brettverwalter hat.
  594.  
  595. Durch diesen flexiblen und modularen Aufbau kann man uebrigens leicht
  596. die Infomail parallel auch an ein Brett adressieren, auf das z.B. nur
  597. SysOp oder andere Verwalter Zugriff haben.
  598.  
  599. Ein Beispiel dieser Batchdatei ist im Lieferumfang/Archiv enthalten.
  600.  
  601. Der Dateipfad/Name kann ueber die Konfigurationsdatei geaendert werden.
  602.  
  603. Ist diese Batchdatei nicht vorhanden , wird sie auch nicht aufgerufen.
  604.  
  605.  
  606.  BViNFOMAIL:
  607.  -----------
  608. Moechtest Du Brettverwaltern eine BVinfomail zuschicken lassen, wenn
  609. es Bonusgutschriften von Files "ihrer" Bretter gibt, kannst Du unter
  610. Verwendung der Batchdatei
  611. prometheus:batches/UBPbvinfomail_gh.bat ein Mailprogramm wie z.B.
  612. EBLcopy von dem UploadBonusPro-Server aufrufen lassen.
  613.  
  614. Bei Brettern ohne Brettverwalter oder einer Gruppe (@NAME) als Brettver-
  615. walter wird keine BVinfomail versendet.
  616.  
  617. Beim Aufruf wird als Parameter Textdatei, Username des Brettverwalters
  618. und der mit einer Bonusgutschrift beguenstigte User uebergeben.
  619.  
  620. Der Aufbau ist genauso flexibel und modular wie der vom Infomail-Batch.
  621. So ist es natuerlich auch moeglich, die BVinfomail statt an den Brett-
  622. verwalter an ein beliebiges Brett zu adressieren, auf das z.B. nur
  623. SysOp oder andere Verwalter Zugriff haben.
  624.  
  625. Ein Beispiel dieser Batchdatei ist ebenfalls im Lieferumfang/Archiv
  626. enthalten.
  627.  
  628. Der Dateipfad/Name kann ueber die Konfigurationsdatei geaendert werden.
  629.  
  630. Ist diese Batchdatei nicht vorhanden , wird sie auch nicht aufgerufen.
  631.  
  632.  
  633.  STOP:
  634.  -----
  635. Da das Serverprg nach der Installierung bei den meisten wohl "unsichtbar"
  636. im Hintergrund laufen wird, prueft das Serverprg die ENV-Variable UBPstop.
  637. Durch Setzen dieser Variable, vom AmigaDOS einfach Befehl "SETENV UBPstop x"
  638. eingeben, kann die Verarbeitung vom Serverprg sofort gestoppt/beendet
  639. werden.
  640.  
  641.  
  642.                                /X\ /X\ /X\
  643.                                \X/ \X/ \X/
  644.  
  645.  
  646.    ___ _ _         _
  647.   / __| (_)___ _ _| |_
  648.  | (__| | / -_) ' \  _|
  649.   \___|_|_\___|_||_\__|
  650.  ----------------------
  651.  
  652. 8. Installation des Clientprg (Install of the clientprg):
  653. ---------------------------------------------------------
  654.  
  655. Der Dateiname des UploadBonusPro-Clientprg ist:
  656.  UBPclient
  657.  
  658. Das UploadBonusPro-Clientprg schreibt immer nur volle KByte auf dem
  659. Downloadfreiraumkonto des User gut,evtl. Restbytes werden zurueckge-
  660. schrieben.
  661.  
  662. Das UploadBonusPro-Clientprg in ein beliebiges Verzeichnis kopieren,
  663. am besten in prometheus: oder prometheus:extern/
  664.  
  665.  
  666. Es gibt mehrere Moeglichkeiten, das Clientprg zu installieren:
  667.  
  668.  
  669.  a) Clientprg als Befehl:
  670.  ------------------------
  671. Um das Clientprg als Befehl/Menuepunkt der Userschaft zur Verfuegung
  672. zu stellen, musst Du dafuer einen NEUEN Befehl in Prometheus anlegen;
  673.  
  674. Im Prometheus-Server unter Konfigurationen "Befehle" aufrufen und den
  675. Befehl wie folgt eintragen:
  676.  
  677.         Name            : UPLOADBONUSPRO
  678.                           (egal, was Du willst!)
  679.  
  680.         Beschreibung    : UploadBonusPro - Gutschrift anzeigen & verbuchen
  681.  
  682.         Parameter       : prometheus:extern/UploadBonusPro-CLiENT $PO
  683.                           (Pfad individuell aendern, jedoch OHNE run-aufruf)
  684.  
  685.         Gruppe          : USER
  686.                           (was Du willst!)
  687.  
  688.         Typ             : DOSDOOR
  689.                           (NICHT arexx/library)
  690.  
  691.         Shortcut        : 14
  692.                           (oder anders!)
  693.  
  694.         Befehl          : bitte einschalten
  695.         Extern          : einschalten (wenn gewuenscht!)
  696.  
  697.         Ports           : nach Belieben einschalten
  698.  
  699.  
  700.  
  701.  b) Clientprg als Befehlsaufruf in Texten:
  702.  -----------------------------------------
  703.  
  704. Wenn Du den UploadBonusPro-Client als Befehl (a) eingebunden hast, kannst
  705. Du ihn auch direkt aus den Prometheus-Texten wie z.B. prometheus:texte/
  706. login.txt aufrufen lassen. Es ist einfach eine Zeile wie
  707. #%Qbefehlsnamevonclientprg
  708. einzutragen, wobei der Befehlsname genauso sein muss wie der, den Du im
  709. Befehlseditor eingetragen hast.
  710.  
  711.  
  712.  c) Clientprg als Dosbefehlsaufruf in Texten:
  713.  --------------------------------------------
  714.  
  715. Du kannst das Clientprg in Texten aufrufen lassen, ohne dieses als
  716. Befehl (a) einzubinden.  Trage dazu einfach eine Zeile wie z.B.
  717. #%Eprogrammpfad/UBPclient $PO [parameter siehe unten]
  718. in einem Prometheus-Text wie z.B. prometheus:texte/login.txt ein.
  719.  
  720. Wenn Du moechtest,dass der Befehl/Programm nur bei Usern einer bestimmten
  721. Gruppe aufgerufen wird, ist der Clientprg-Aufruf auch so moeglich:
  722. #%@gruppenname
  723. #%Eprogrammpfad/UBPclient $PO [parameter siehe unten]
  724. #%*
  725. #%!
  726.  
  727.  
  728.  d) Clientprg als Dosbefehlsaufruf in Batches:
  729.  ---------------------------------------------
  730.  
  731. Um das Clientprg von einem Prometheus-Batch wie z.B. Login.bat aufzurufen,
  732. musst Du einfach eine Zeile wie z.B.
  733. programmpfad/UBPclient $PO [parameter siehe unten]
  734. in dieses batch fuegen.
  735.  
  736. WICHTIGER Hinweis: Bitte KEIN run oder #run verwenden !
  737.  
  738.  
  739.                                /X\ /X\ /X\
  740.                                \X/ \X/ \X/
  741.  
  742.  
  743. 9. Konfiguration des Clientprg (Configs of the clientprg):
  744. ----------------------------------------------------------
  745.  
  746.  GRUPPEN:
  747.  --------
  748. User, die in der Gruppe UBP-NOBONUS sind, koennen das Clientprg nicht
  749. aufrufen; nach dem Aufruf beendet sich das Clientprg sofort wieder,
  750. ohne irgendetwas anzuzeigen oder gutzuschreiben.
  751.  
  752. Ist der User in der Gruppe UBP-NOPROTO, kann dieser NICHT das user-
  753. globale Protokoll, welches ggf. fuer ihn in seinem Postfach-DIR
  754. liegt, behandeln.
  755.  
  756. Die UploadBonusPro-Gruppen UBP-KASCHIER , UBP-NOINFO und UBP-NOBVINFO
  757. werden vom Clientprg nicht abgefragt.
  758.  
  759.  
  760.  PARAMETER:
  761.  ----------
  762. Dem Dosaufruf kann man folgende Parameter uebergeben, wodurch sich das
  763. UploadBonusPro-Clientprg jeweils etwas anders verhaelt, sodass dieses
  764. der Aufrufumgebung (z.B. Login) ideal angepasst werden kann.
  765.  
  766.  Parameter:    Erklaerung:
  767.  ---------------------------------------------------------------------
  768.   keine        wie 20000
  769.  
  770.       0        wie 20000
  771.  
  772.       1        wie 20001
  773.  
  774.   20000        ohne Parameter wird ganz normal das Menue angeboten;
  775.                ist der User in der Gruppe UBP-NOBONUS, wird OHNE
  776.                irgendeine Ausgabe beendet.  Die Teilnahme des Users
  777.                an Gruppe UBP-NOPROTO bewirkt keine Protokollauswahl.
  778.                Das Verbuchen von Bonus-Gutschriften wird fuer den
  779.                SysOp natuerlich mitprotokolliert.
  780.  
  781.   20001        wie 20000 , jedoch ohne grosses Titellogo
  782.  
  783.   20500        wie 20000 , gibt es jedoch keinen bonus zu Verbuchen wird
  784.                ohne Ausgabe wieder beendet, ideal fuer den Login.
  785.  
  786.   20501        wie 20001 , jedoch ohne grosses Titellogo
  787.  
  788.   21000        Verbuchen einer evtl. vorhandenen Gutschrift; ist
  789.                keine Gutschrift vorhanden, wird ohne Ausgabe beendet.
  790.  
  791.   21001        Verbuchen einer evtl. vorhandenen Gutschrift,
  792.                jedoch ohne grosses Titellogo; ist keine Gutschrift
  793.                vorhanden, wird ohne Ausgabe beendet.
  794.  
  795.   22000        Verbuchen einer evtl. vorhandenen Gutschrift OHNE
  796.                irgendeine Ausgabe.
  797.  
  798.   22100        Verbuchen einer evtl. vorhandenen Gutschrift OHNE
  799.                irgendeine Ausgabe und schickt dem User eine Nachricht
  800.                (OLM) auf seinen Port, in der er ueber die gerade
  801.                verbuchten KByte auf seinem DL-Freiraumkonto informiert
  802.                wird.
  803.  
  804.   23000        Prueft lediglich, ob eine zu verbuchende Gutschrift
  805.                vorhanden ist, und schickt dem User eine Nachricht(OLM)
  806.                auf seinen Port, in der er darueber informiert wird,
  807.                wieviel KByte UploadBonusPro fuer ihn bereithaelt.
  808.                Sinnvoller Einbau in prometheus:texte/download.txt
  809.                oder prometheus:text/upload.bat oder postolm.bat
  810.  
  811.   24000        Bonus-Backup-Datei pruefen; ggf. anzeigen, dass durch
  812.                Boxreset/Boxabsturz die letzte Bonusgutschrift nicht
  813.                in den Userdaten gespeichert werden konnte.  Info: die
  814.                Userdaten speichert Prometheus bekanntlich erst
  815.                nach dem Logoff; kommt es vorher zu einem System-
  816.                abbruch (Reset/Absturz), sind Aenderungen in den
  817.                Userdaten wie Freiraumveraenderungen durch Upload,
  818.                Download und auch UploadBonusPro VERLOREN.
  819.                Der UploadBonusPro-Client sorgt dafuer, dass Bonus-
  820.                gutschriften fuer User nicht vergessen werden und
  821.                identifiziert evtl. durchzufuehrende Gutschriften
  822.                der Bonus-Backdatei anhand der Useranrufe.
  823.                Der 24000 Aufruf daher BITTE NUR EINMAL pro Login,
  824.                am besten in die LOGIN.BAT oder LOGIN.TXT vor dem
  825.                bisherigen ersten UploadBonusPro-Client-Aufruf.
  826.                Dies ist sehr wichtig fuer das korrekte Funktionieren
  827.                dieses Features.
  828.                Bei 24000 wird ein erklaerender Text mit nachfolgender
  829.                Tastenpause angezeigt.
  830.                Ist das Bonus-Backup ueberfluessig, wird die Backupdatei
  831.                geloescht und es findet keine Textausgabe statt;
  832.                natuerlich wird in dem Fall auch nicht die Tastenpause
  833.                erscheinen.
  834.                Natuerlich wird diese Bonus-Backup-Gutschrift wie die
  835.                normale Bonusgutschrift im Protokoll:
  836.                prometheus:protokolle/UBPclient-Freiraum_gh.prt
  837.                fuer den SysOp protokolliert.
  838.  
  839.   24001        wie vor, jedoch ohne grosses Titellogo
  840.  
  841.   24100        wie Parameter 24000, jedoch wird statt erklaerendem
  842.                Text und Tastenpause nur eine OLM abgesetzt, die den
  843.                User dezent informiert, dass ein Bonus-Backup gutge-
  844.                schrieben wurde.
  845.  
  846.   24200        wie Parameter 24000, jedoch OHNE ALLE Ausgabe, KEINE
  847.                Tastenpause, KEINE OLM.   Es wird stillschweigend
  848.                der Bonus-Backup-Wert gutgeschrieben.
  849.  
  850.  
  851.  
  852.  
  853. ...weitere Aufrufvarianten & Features sind in Arbeit !
  854.  
  855.  
  856.                                /X\ /X\ /X\
  857.                                \X/ \X/ \X/
  858.  
  859.  
  860. 10. Deinstallation (Deinstallation):
  861. ------------------------------------
  862.  
  863. Das mitgelieferte batch UNinstall.bat, welches mittels c:execute gestartet
  864. wird , entfernt (loescht) alle DURCH den UploadBonusPro-Serverprg angelegten
  865. Dateien aus der Prometheus-Verzeichnisstruktur.
  866.  
  867.  
  868.                                /X\ /X\ /X\
  869.                                \X/ \X/ \X/
  870.  
  871.  
  872. 5. Versionsgeschichte (History & Changes):
  873. ------------------------------------------
  874.  
  875.  SERVERPRG:
  876.  ----------
  877. v0.10beta bis v0.14beta nur interne Versionen
  878.  
  879. v0.15beta - Testversion fuer Betatester
  880.  
  881. v0.16beta - Einfuehrung Konfigurationsdatei (Wert Wartelimit)
  882.  
  883. v0.17beta - Ergibt der Zeitpunktcheck einen juengeren Zeitpunkt,
  884.             wird nicht fuer jede uebersprungene Zeile eine
  885.             Verarbeitungszeile ausgegeben. (=schneller)
  886.  
  887.           - Werden Zeilen durch Zeitpunktcheck oder Zeilencheck
  888.             uebersprungen, wird fuer folgende uebersprungene Zeilen
  889.             keine Arbeitsausgabe mehr getaetigt, wodurch die Suche
  890.             nach der naechsten verarbeitungswuerdigen Zeile sehr
  891.             viel schneller beendet ist.
  892.  
  893. v0.18beta - Bug entfernt: statt des Netzboxnamen wurde die Kontrolle
  894.             auf boxeigene Netzmails (z.B. von Points) mit dem Boxnamen
  895.             durchgefuehrt.
  896.  
  897.           - Der Boxname, in UploadBonusPro-Serverprg Boxtitel genannt,
  898.             wird nun in dem Text der infomails verwendet.
  899.  
  900.           - Parameterabfrage auf NOCFGFILE - keine Konfigurationsdatei-
  901.             auswertung.
  902.  
  903.           - Abfrage einer Sicherheitsdatei, welche einen Doppelaufruf
  904.             vom UploadBonusPro-Serverprg verhindert.
  905.  
  906.           - Es wird beim Start geprueft, ob alle benoetigten AmigaDOS-
  907.             Befehle vorhanden sind.
  908.  
  909.           - Bug entfernt: der Dupecheck klappte nicht 100%ig
  910.  
  911. v0.19beta - Abfrage der Datei env:UBPstop - bei Vorhandensein wird das
  912.             Serverprg sich sofort beenden.
  913.  
  914. v0.20beta - Bug entfernt: die Erkennung von Fremdboxabsendern geht
  915.             nun einwandfrei.
  916.  
  917.           - Beim Start wird nun erkannt, ob der Benutzer selbst die
  918.             Startzeilen- und Startzeitpunktdatei geloescht hat.
  919.  
  920. v0.21beta - Neue Konfigurationsmoeglichkeiten: infomailbatch-schalter
  921.  
  922.           - Neue Konfigurationsmoeglichkeiten: prozentuale Bonusgutschrift
  923.  
  924.           - Gruppencheck etwas schneller.
  925.  
  926.           - Brettsuche perfektioniert: es wird nun primaer auch ueber
  927.             den DOS-Pfad ein passendes Brett gesucht.  Sekundaer wird
  928.             ueber den moeglichen Brettpfad ein passendes Brett gesucht.
  929.  
  930.           - Etwas Kosmetik: Textausgaben etwas korrigiert.
  931.  
  932.           - Protokollformat geaendert aufgrund der prozentualen
  933.             Bonusberechnung.
  934.  
  935.           - Bug entfernt: infomailtext einer allerersten gutschrift
  936.             fuer einen user wurde mit falschen Parametern uebergeben.
  937.  
  938.           - Prozentualer Bonuswert wird auf Kommastelle genau geprueft,
  939.             um ggf. zu runden.  Exakte Berechnung bis in den Gigabyte-
  940.             bereich.
  941.  
  942.           - Neue Konfigurationsmoeglichkeiten: Prozentinfo, Bonusbyteinfo,
  943.             Fileinfo, Brettinfo, Userprotokoll.
  944.  
  945.           - Neue Konfigurationsmoeglichkeiten: BVcheck, BVinfomail,
  946.             UserbonusBVdownload, BVbonusUserdownload, infomaildatei,
  947.             BVinfomaildatei
  948.  
  949.           - Neue Konfigurationsmoeglichkeiten: infomailbatch, bvinfo-
  950.             mailbatch
  951.  
  952.           - Bug entfernt: die Prozentgutschrift konnte auf 0% gesetzt
  953.             werden; nun wird bei einem %-wert kleiner als 1 und groesser
  954.             als 100 der Standartwert aktiviert.
  955.  
  956. v0.22beta - Neue Konfigurationsmoeglichkeiten: Gruppenchecks generell,
  957.             GrpCheck UBP-KASCHIER, GrpCheck UBP-NOBONUS, GrpCheck UBP-NOPROTO
  958.  
  959.           - Gruppencheck der Gruppe UBP-NOPROTO nun erst direkt vor der
  960.             Erstellung des userglobalen Protokolls. (schneller!)
  961.  
  962.           - Neue Gruppen: UBP-NOINFO und UBP-NOBVINFO
  963.  
  964.           - Neue Konfigurationsmoeglichkeiten: GrpCheck UBP-NOINFO und
  965.             GrpCheck UBP-NOBVINFO
  966.  
  967.           - Neue Gruppen-Moeglichkeiten; man kann nun beliebige Gruppen
  968.             anlegen mit den Namen "UBP-BONUS" beginnend; die Zahl im
  969.             Gruppennamen ist die Prozentzahl, die die User, die der Gruppe
  970.             angehoeren, fuer Downloads ihrer Uploads bekommen.  Genial!!!
  971.  
  972.           - Nun ist es moeglich, die Bonusgutschriften zu limitieren;
  973.             es werden dabei die ueber die Dupecheck-Dateien verzeichneten
  974.             Filezugriffe gezaehlt; einstellbar ueber Konfigurationsdatei.
  975.  
  976.           - Downloads aus FREE-DL-Brettern koennen nun gemaess Konfig.Datei
  977.             auch verguetet werden, wenn man es mit einen speziellen
  978.             Prozentwert einstellt.
  979.  
  980.           - Der Dupecheck kann generell ausgeschaltet werden.
  981.  
  982.           - Neue Konfigurationsmoeglichkeiten: GrpCheck UBP-BONUSxxx ,
  983.             Filezugrifflimit, FREE-DL-Brett-Gutschrift , FREE-DL-Brett-
  984.             Gutschrift-Prozente, Dupecheck generell
  985.  
  986.           - Neue Konfigurationsmoeglichkeiten: BonusGruppen-Richtung
  987.  
  988.           - Nun kann man auch LimitGruppen UBP-LIMITxxxxx erstellen, welche
  989.             userbezogen die Bonusgutschriften auf 1-99999 begrenzen.
  990.  
  991.           - Mit der neuen Gruppe UBP-NOLIMIT kann man fuer bestimmte User
  992.             eine eingestellte Limitierung der Bonusgutschriften umgehen.
  993.  
  994.           - Neue Konfigurationsmoeglichkeiten: GrpCheck UBP-NOLIMIT ,
  995.             LimitGruppen-Richtung
  996.  
  997.           - Auslesen von Fuss- und Kopftextdatei bei Erstellung von
  998.             infotextdatei. (max. 10 Zeilen)
  999.  
  1000.           - Neue Konfigurationsmoeglichkeiten: Dateiname Kopftext, Datei-
  1001.             name Fusstext, Kopftext hinzufuegen, Fusstext hinzufuegen.
  1002.  
  1003.           - Etwas Kosmetik an den Textausgaben.
  1004.  
  1005. v0.23beta - Programmsource optimiert.
  1006.  
  1007.           - Bug entfernt: beim allerersten Start kann nun einfach wie an-
  1008.             gezeigt mit ENTER/CR fortgesetzt werden.
  1009.  
  1010.           - Beim allerersten Start bzw. wenn keine Zeitpunktdatei vorhanden
  1011.             ist , wird eine Standartdatei geschrieben.
  1012.  
  1013.           - Beim Start und Ende von UBPserver wird das aktuelle Datum sowie
  1014.             die Uhrzeit ausgegeben (wichtig fuer Umleitung in Protokolle).
  1015.  
  1016.           - Bug entfernt: In der Routine fuer den Dupecheck nach Filenamen
  1017.             war ein Fehler, der zum Abbruch von UBPserver fuehrte , wenn
  1018.             ein Dupecheck ohne MSGID durchgefuehrt werden sollte.
  1019.  
  1020.           - Bug entfernt: Datum/Zeit im Protokoll wurde nicht korrekt
  1021.             uebergeben.
  1022.  
  1023.           - Ueberfluessige Textausgabe gekillt (UBP-NOLIMIT uebersprungen),
  1024.             da dieser Check sowieso nur gemacht wird, wenn das erforderlich
  1025.             ist.
  1026.  
  1027. v0.24beta - Neue Konfigurationsmoeglichkeiten: Sysopmail-Batch-Aufruf
  1028.  
  1029. v0.25beta - Bug entfernt: Parameteruebergabe des Sysopmail-Batch-Aufrufs
  1030.             war nicht ganz okay.
  1031.  
  1032. v0.26beta - etwas Kosmetik.
  1033.  
  1034.           - Texte der beiliegenden batchdateien ueberarbeitet.
  1035.  
  1036.  
  1037.  
  1038. Hinweis: genaue Erklaerungen zu neuen Funktionen; Programmaenderungen werden
  1039.          generell in den uebrigen Punkten wie z.B. Konfiguration jeweils
  1040.          erweitert oder korrigiert.
  1041.  
  1042.  
  1043.  CLiENTPRG:
  1044.  ----------
  1045. v0.10beta bis v.19beta nur interne Versionen
  1046.  
  1047. v0.20beta - Abfragen der Gruppen und Einschraenkung der Auswahl
  1048.  
  1049. v0.21beta - Verbuchen von Gutschriften nach diversen Schutzabfragen
  1050.  
  1051. v0.22beta - Bug entfernt: Programm liess sich nicht ausfuehren.
  1052.  
  1053.           - Einfuehrung der Aufruf-Parameter 0 bis 23000
  1054.  
  1055. v.023beta - Bug entfernt: nach dem Anzeigen des Hilfstextes wurde
  1056.             nicht auf einen Tastendruck gewartet, sodass dieser sofort
  1057.             wieder verschwand.
  1058.  
  1059.           - Ab sofort legt der UBPclient beim Verbuchen von Bonusgutschriften,
  1060.             egal mit welchem Parameter aufgerufen, ein boxglobales Protokoll
  1061.             unter prometheus:protokolle/UBPclient-Freiraum_gh.prt an, welches
  1062.             folgende Daten anzeigt:  Port , Boxanrufnummer , Datum , Zeit ,
  1063.             Username , Freiraum vor dem Verbuchen , Bonusgutschrift ,
  1064.             Freiraum nach dem Verbuchen , Bonusrestbyte.
  1065.  
  1066. v0.24beta - Bug entfernt: bei 1024 Byte Bonus wurde keine Gutschrift
  1067.             angezeigt.
  1068.  
  1069.           - Einfuehrung einer genialen Backup-Bonusbyte-Routine, welche
  1070.             ueber die neuen Parametercodes 24000-24200 angesteuert wird.
  1071.             = KEINE Bytebonusgutschrift kann jemals verloren gehen, wenn
  1072.             der Rechner resetet/abstuerzt....Parametercodes 24000-24200
  1073.             never forget.   Ich finde es genial!!!
  1074.  
  1075.           - Etwas Kosmetik an den OLM-Texten.
  1076.  
  1077. v0.25beta - Neue Parametercodes 20500 und 20501.
  1078.  
  1079. v0.26beta - Hilfstext ueberarbeitet.
  1080.  
  1081.  
  1082.  
  1083. Hinweis: genaue Erklaerungen zu neuen Funktionen; Programmaenderungen werden
  1084.          generell in den uebrigen Punkten wie z.B. Konfiguration jeweils
  1085.          erweitert oder korrigiert.
  1086.  
  1087.  
  1088.                                /X\ /X\ /X\
  1089.                                \X/ \X/ \X/
  1090.  
  1091.  
  1092. 12. Haftungswiderspruch (Responsibility):
  1093. -----------------------------------------
  1094.  
  1095. Ich gebe keine Garantie fuer irgendetwas!
  1096.  
  1097. Die Benutzung geschieht auf Dein eigenes Risiko; ich erklaere mich jedoch
  1098. bereit, Fehler fuer registrierte Benutzer durch kostenfreie Updates zu
  1099. beheben.
  1100.  
  1101.  
  1102.                                /X\ /X\ /X\
  1103.                                \X/ \X/ \X/
  1104.  
  1105.  
  1106. 13. Urheberrechte (Copyrights):
  1107. -------------------------------
  1108.  
  1109. Das Urheberrecht © von UploadBonusPro liegt bei Frank Hartung, 1996.
  1110. UploadBonuspro is copyright © by Frank Hartung, 1996.
  1111.  
  1112. Alle Rechte an UploadBonusPro liegen bei Frank Hartung, Programmierer
  1113. vom UploadBonusPro-Paket, sowie Systembetreiber der FREEWAY.
  1114. Das Programmpaket darf nur komplett und unveraendert weitergegeben
  1115. werden. Eine etwaige Kopiergebuehr darf den Wert des Datentraegers
  1116. nicht ueberschreiten. Eine grossvolumige Verbreitung - z.B. CD-ROM -
  1117. benoetigt das Einverstaendnis des Programmierers.
  1118.  
  1119. Die Rechte der ptTools.library liegen bei Andi@A-Angels.aworld.de
  1120.  
  1121.  
  1122.                                /X\ /X\ /X\
  1123.                                \X/ \X/ \X/
  1124.  
  1125.  
  1126. 14. Danksagungen & Gruesse (Thanks & greetings):
  1127. ------------------------------------------------
  1128.  
  1129. An EBL@stardate fuer die Korrektur meines ersten arexx-scripts und fuer seine
  1130.  genialen EBL-Tools, insbesondere EBLmapsel und EBLcopy.
  1131.  
  1132. An hunz@lahn-eck, der stets geduldig ist, wenn ich wieder mal ne Idee habe,
  1133. und der mir bereits mit einigen arexx-scripten geholfen hat   :)
  1134.  
  1135. An M.BRUECKNER fuer PMBS !
  1136.  
  1137. An Andi@A-Angels.dssd.sub.org fuer die geniale pttools.library
  1138.  
  1139. An das KF-Team fuer diverse Tools.
  1140.  
  1141. und insbesondere an GiNA , ohne die diese Anleitung sehr viele Vehler ;)
  1142.  beinhalten wuerde.
  1143.  
  1144.  
  1145.                                /X\ /X\ /X\
  1146.                                \X/ \X/ \X/
  1147.  
  1148.  
  1149. 15. Updates & Fehlermeldungen (Updates & bugreports):
  1150. -----------------------------------------------------
  1151.  
  1152. Bugreports sind in ordentlicher Form direkt an mich zu richten:
  1153.  sysop@freeway.shnet.org
  1154.  
  1155. Verbesserungsvorschlaege und Ideen sind willkommen.
  1156.  
  1157. Sollte etwas dringendes anliegen, so bin ich via VOICE
  1158. taeglich unter 0431 338375 ab 20 uhr bis 23 uhr erreichbar.
  1159.  
  1160. Ansonsten kann man mich stets ueber meine Box erreichen....
  1161.  
  1162.  
  1163.                                /X\ /X\ /X\
  1164.                                \X/ \X/ \X/
  1165.  
  1166.  
  1167. 16. Benutzungsbedingungen (Restrictions of use):
  1168. ------------------------------------------------
  1169. Dieses Programmpaket darf nur komplett und UNVERAENDERT weitergegeben
  1170. werden.   Die Benutzung geschieht unter dem Aspekt der Shareware-Idee.
  1171.  
  1172. Wer dieses Programmpaket benutzen moechte, muss mir eine ihm angemessene
  1173. Shareware-Gebuehr ueberweisen, oder falls es sich bei dem Benutzer um
  1174. einen Programmierer handelt, mir ein fuer mich brauchbares Programm
  1175. senden, welches er selbst programmiert hat.  Ist fuer dieses Programm
  1176. ebenfalls eine Shareware-Gebuehr noetig, entfaellt diese (schlicht um
  1177. schlicht!).  Ein evtl. benoetigtes Keyfile bitte mitschicken !
  1178.  
  1179. Die Personen, welche ich unter Punkt 14 (Danksagungen & Gruesse) erwaehnt
  1180. habe, sind von Entrichtung einer Shareware-Gebuehr befreit.
  1181.  
  1182. Ansonsten darf der Benutzer SELBST entscheiden, wieviel ihm UploadBonusPro
  1183. wert ist und sich durch Ueberweisung dieses Betrages dafuer bei mir als
  1184. Benutzer registrieren lassen.
  1185.  
  1186. Wird UploadBonusPro nach den obigen Bedingungen nicht registriert, dann
  1187. benutzt und unterstuetzt der Anwender (Systembetreiber) damit das
  1188. Raubkopier-Milieu und wird in tausend Jahren und mehr immer noch keine
  1189. Ruhe finden.
  1190.  
  1191.  
  1192. Fuer alle (eher wenige) Faelle, hier meine Bankverbindung:
  1193. Kontoinhaber: Frank Hartung    Kontonummer : 021169 1049
  1194. Bankleitzahl: 300 209 00       Bankname    : Citibank  (FRG)
  1195. Der Betreff sollte moeglichst UBP sowie eine EMailadresse enthalten.
  1196.  
  1197.  
  1198. .-._.-._.-._.-._.-._.-._.-._.-._.-._.-._.-.-._.-._.-._.-._.-._.-._.-._.-._.-.
  1199. -._.-._.-._.-._.-._.-._.-._.-._.-._.-._.-.-._.-._.-._.-._.-._.-._.-._.-._.-._
  1200. ._.-._.-._.-._.-._.-._.-._.-._.-._.-._.-._._.-._.-._.-._.-._.-._.-._.-._.-._.
  1201.  
  1202.  
  1203.  
  1204.            Herzen koennen fliegen - durch Zeit und Raum ...
  1205.  
  1206. cu, Hardy   __  _   __  __        __        sysop@freeway.SHNET.ORG
  1207.            /_  /_) /_  /_  / / / /_/ (_/   0431,338382/338310/338352
  1208.           /   / ( /_  /_  /_/_/ / / __/   connect28800/^19200/^28800v.34
  1209.